Summary

This PR implements the sortora stats command that provides comprehensive statistics and reports about file organization activities.

Features Added

• Period-based statistics (day/week/month):

  • Number of files organized per period
  • Breakdown by operation type (move, copy, delete)
  • Breakdown by rule triggered

• Top rules analysis:

  • Top 10 most frequently triggered rules
  • Last usage timestamp for each rule

• Duplicate files statistics:

  • Number of duplicate groups detected
  • Potential space savings from removing duplicates
  • Count of deleted duplicates and actual space saved

• Overall statistics:

  • Total files analyzed
  • Total size tracked
  • Total operations performed
  • File distribution by category

Command Options

sortora stats              # Show all statistics
sortora stats --json       # Output in JSON format
sortora stats --period day # Stats for today only
sortora stats --rules      # Show only top rules
sortora stats --duplicates # Show only duplicate stats

Implementation Details

Files modified:

• src/storage/database.ts - Added new query methods:

  • getOperationsByPeriod() - Get stats filtered by time period
  • getTopRules() - Get most frequently triggered rules
  • getDuplicateStats() - Calculate duplicate file statistics
  • getDeletedDuplicatesStats() - Track removed duplicates and saved space
  • getActivityTimeline() - Get activity data for visualization

• src/ui/table.ts - Added rendering functions:

  • renderStatsOverview() - Period comparison table
  • renderTopRules() - Rules ranking table
  • renderDuplicateStats() - Duplicate analysis table
  • renderOverallStats() - General statistics and category breakdown

• src/cli.ts - Added the stats command with all options

This PR was written using Vibe Kanban